/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / pp / pp-6.0 / doc / manual / volume2 / channels.tex / node14_ct.html

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 3c 21 44 4f 43 54 59 50 | 45 20 48 54 4d 4c 20 50 |<!DOCTYP|E HTML P|
|00000010| 55 42 4c 49 43 20 22 2d | 2f 2f 57 33 43 2f 2f 44 |UBLIC "-|//W3C//D|
|00000020| 54 44 20 48 54 4d 4c 20 | 33 2e 32 20 46 69 6e 61 |TD HTML |3.2 Fina|
|00000030| 6c 2f 2f 65 6e 22 3e 0a | 0a 3c 21 2d 2d 43 6f 6e |l//en">.|.<!--Con|
|00000040| 76 65 72 74 65 64 20 77 | 69 74 68 20 4c 61 54 65 |verted w|ith LaTe|
|00000050| 58 32 48 54 4d 4c 20 32 | 30 32 32 20 28 52 65 6c |X2HTML 2|022 (Rel|
|00000060| 65 61 73 65 64 20 4a 61 | 6e 75 61 72 79 20 31 2c |eased Ja|nuary 1,|
|00000070| 20 32 30 32 32 29 20 2d | 2d 3e 0a 3c 48 54 4d 4c | 2022) -|->.<HTML|
|00000080| 20 6c 61 6e 67 3d 22 65 | 6e 22 3e 0a 3c 48 45 41 | lang="e|n">.<HEA|
|00000090| 44 3e 0a 3c 54 49 54 4c | 45 3e 43 6f 6e 74 65 6e |D>.<TITL|E>Conten|
|000000a0| 74 73 20 6f 66 20 41 64 | 64 72 65 73 73 20 50 61 |ts of Ad|dress Pa|
|000000b0| 72 73 69 6e 67 3c 2f 54 | 49 54 4c 45 3e 0a 0a 3c |rsing</T|ITLE>..<|
|000000c0| 4d 45 54 41 20 48 54 54 | 50 2d 45 51 55 49 56 3d |META HTT|P-EQUIV=|
|000000d0| 22 43 6f 6e 74 65 6e 74 | 2d 54 79 70 65 22 20 43 |"Content|-Type" C|
|000000e0| 4f 4e 54 45 4e 54 3d 22 | 74 65 78 74 2f 68 74 6d |ONTENT="|text/htm|
|000000f0| 6c 3b 20 63 68 61 72 73 | 65 74 3d 75 74 66 2d 38 |l; chars|et=utf-8|
|00000100| 22 3e 0a 3c 4d 45 54 41 | 20 4e 41 4d 45 3d 22 76 |">.<META| NAME="v|
|00000110| 69 65 77 70 6f 72 74 22 | 20 43 4f 4e 54 45 4e 54 |iewport"| CONTENT|
|00000120| 3d 22 77 69 64 74 68 3d | 64 65 76 69 63 65 2d 77 |="width=|device-w|
|00000130| 69 64 74 68 2c 20 69 6e | 69 74 69 61 6c 2d 73 63 |idth, in|itial-sc|
|00000140| 61 6c 65 3d 31 2e 30 22 | 3e 0a 3c 4d 45 54 41 20 |ale=1.0"|>.<META |
|00000150| 4e 41 4d 45 3d 22 47 65 | 6e 65 72 61 74 6f 72 22 |NAME="Ge|nerator"|
|00000160| 20 43 4f 4e 54 45 4e 54 | 3d 22 4c 61 54 65 58 32 | CONTENT|="LaTeX2|
|00000170| 48 54 4d 4c 20 76 32 30 | 32 32 22 3e 0a 0a 3c 4c |HTML v20|22">..<L|
|00000180| 49 4e 4b 20 52 45 4c 3d | 22 53 54 59 4c 45 53 48 |INK REL=|"STYLESH|
|00000190| 45 45 54 22 20 48 52 45 | 46 3d 22 63 68 61 6e 6e |EET" HRE|F="chann|
|000001a0| 65 6c 73 2e 63 73 73 22 | 3e 0a 0a 3c 4c 49 4e 4b |els.css"|>..<LINK|
|000001b0| 20 52 45 4c 3d 22 6e 65 | 78 74 22 20 48 52 45 46 | REL="ne|xt" HREF|
|000001c0| 3d 22 6e 6f 64 65 31 35 | 5f 6d 6e 2e 68 74 6d 6c |="node15|_mn.html|
|000001d0| 22 3e 0a 3c 4c 49 4e 4b | 20 52 45 4c 3d 22 70 72 |">.<LINK| REL="pr|
|000001e0| 65 76 69 6f 75 73 22 20 | 48 52 45 46 3d 22 6e 6f |evious" |HREF="no|
|000001f0| 64 65 31 33 5f 6d 6e 2e | 68 74 6d 6c 22 3e 0a 3c |de13_mn.|html">.<|
|00000200| 4c 49 4e 4b 20 52 45 4c | 3d 22 75 70 22 20 48 52 |LINK REL|="up" HR|
|00000210| 45 46 3d 22 6e 6f 64 65 | 31 32 5f 6d 6e 2e 68 74 |EF="node|12_mn.ht|
|00000220| 6d 6c 22 3e 0a 3c 4c 49 | 4e 4b 20 52 45 4c 3d 22 |ml">.<LI|NK REL="|
|00000230| 6e 65 78 74 22 20 48 52 | 45 46 3d 22 6e 6f 64 65 |next" HR|EF="node|
|00000240| 31 35 5f 6d 6e 2e 68 74 | 6d 6c 22 3e 0a 3c 2f 48 |15_mn.ht|ml">.</H|
|00000250| 45 41 44 3e 0a 20 0a 3c | 42 4f 44 59 20 62 67 63 |EAD>. .<|BODY bgc|
|00000260| 6f 6c 6f 72 3d 22 23 66 | 66 66 66 66 66 22 20 74 |olor="#f|fffff" t|
|00000270| 65 78 74 3d 22 23 30 30 | 30 30 30 30 22 20 6c 69 |ext="#00|0000" li|
|00000280| 6e 6b 3d 22 23 39 39 34 | 34 45 45 22 20 76 6c 69 |nk="#994|4EE" vli|
|00000290| 6e 6b 3d 22 23 30 30 30 | 30 66 66 22 20 61 6c 69 |nk="#000|0ff" ali|
|000002a0| 6e 6b 3d 22 23 30 30 66 | 66 30 30 22 3e 0a 0a 3c |nk="#00f|f00">..<|
|000002b0| 48 32 3e 3c 41 20 49 44 | 3d 22 53 45 43 54 49 4f |H2><A ID|="SECTIO|
|000002c0| 4e 30 30 31 33 32 30 30 | 30 30 30 30 30 30 30 30 |N0013200|00000000|
|000002d0| 30 30 30 30 30 22 3e 0a | 41 64 64 72 65 73 73 20 |00000">.|Address |
|000002e0| 50 61 72 73 69 6e 67 3c | 2f 41 3e 0a 3c 2f 48 32 |Parsing<|/A>.</H2|
|000002f0| 3e 0a 0a 3c 50 3e 0a 4f | 63 63 61 73 69 6f 6e 61 |>..<P>.O|ccasiona|
|00000300| 6c 6c 79 20 69 74 20 69 | 73 20 6e 65 63 65 73 73 |lly it i|s necess|
|00000310| 61 72 79 20 66 6f 72 20 | 61 20 63 68 61 6e 6e 65 |ary for |a channe|
|00000320| 6c 20 74 6f 20 70 61 72 | 73 65 20 6f 72 20 6d 61 |l to par|se or ma|
|00000330| 6e 69 70 75 6c 61 74 65 | 20 61 6e 0a 61 64 64 72 |nipulate| an.addr|
|00000340| 65 73 73 2e 20 4d 6f 73 | 74 20 63 68 61 6e 6e 65 |ess. Mos|t channe|
|00000350| 6c 73 20 63 61 6e 20 67 | 65 74 20 61 77 61 79 20 |ls can g|et away |
|00000360| 77 69 74 68 6f 75 74 20 | 6e 65 65 64 69 6e 67 20 |without |needing |
|00000370| 74 68 69 73 20 68 6f 77 | 65 76 65 72 2e 0a 53 6f |this how|ever..So|
|00000380| 6d 65 20 6f 66 20 74 68 | 65 20 62 61 73 69 63 20 |me of th|e basic |
|00000390| 70 61 72 73 69 6e 67 20 | 72 6f 75 74 69 6e 65 73 |parsing |routines|
|000003a0| 20 61 72 65 20 67 69 76 | 65 6e 20 68 65 72 65 2e | are giv|en here.|
|000003b0| 0a 0a 3c 50 3e 0a 54 68 | 65 20 62 61 73 69 63 20 |..<P>.Th|e basic |
|000003c0| 69 6e 74 65 72 66 61 63 | 65 20 74 6f 20 70 61 72 |interfac|e to par|
|000003d0| 73 69 6e 67 20 69 73 20 | 3c 63 6f 64 65 3e 61 64 |sing is |<code>ad|
|000003e0| 5f 70 61 72 73 65 3c 2f | 63 6f 64 65 3e 2e 20 54 |_parse</|code>. T|
|000003f0| 68 69 73 20 74 61 6b 65 | 73 20 61 6e 0a 61 64 64 |his take|s an.add|
|00000400| 72 65 73 73 20 61 6e 64 | 20 61 74 74 65 6d 70 74 |ress and| attempt|
|00000410| 73 20 74 6f 20 70 61 72 | 73 65 20 69 74 20 61 63 |s to par|se it ac|
|00000420| 63 6f 72 64 69 6e 67 20 | 74 6f 20 74 68 65 20 67 |cording |to the g|
|00000430| 69 76 65 6e 20 74 79 70 | 65 20 61 6e 64 0a 64 6f |iven typ|e and.do|
|00000440| 6d 61 69 6e 20 6f 72 64 | 65 72 69 6e 67 2e 20 49 |main ord|ering. I|
|00000450| 74 20 69 73 20 63 61 6c | 6c 65 64 20 61 73 3a 0a |t is cal|led as:.|
|00000460| 0a 3c 50 3e 0a 3c 42 4c | 4f 43 4b 51 55 4f 54 45 |.<P>.<BL|OCKQUOTE|
|00000470| 3e 0a 3c 41 20 49 44 3d | 22 32 30 32 22 3e 3c 2f |>.<A ID=|"202"></|
|00000480| 41 3e 3c 2f 42 4c 4f 43 | 4b 51 55 4f 54 45 3e 3c |A></BLOC|KQUOTE><|
|00000490| 50 52 45 3e 0a 69 6e 74 | 20 61 64 5f 70 61 72 73 |PRE>.int| ad_pars|
|000004a0| 65 20 28 61 70 2c 20 72 | 70 2c 20 6f 72 64 65 72 |e (ap, r|p, order|
|000004b0| 29 0a 41 44 44 52 09 2a | 61 70 3b 0a 52 50 5f 42 |).ADDR.*|ap;.RP_B|
|000004c0| 75 66 20 2a 72 70 3b 0a | 69 6e 74 20 6f 72 64 65 |uf *rp;.|int orde|
|000004d0| 72 3b 0a 3c 2f 50 52 45 | 3e 0a 0a 3c 50 3e 0a 54 |r;.</PRE|>..<P>.T|
|000004e0| 68 65 20 70 61 72 61 6d | 65 74 65 72 73 20 61 72 |he param|eters ar|
|000004f0| 65 3a 0a 3c 42 52 3e 0a | 3c 49 4d 47 0a 20 20 53 |e:.<BR>.|<IMG.  S|
|00000500| 54 59 4c 45 3d 22 22 20 | 53 52 43 3d 22 69 6d 67 |TYLE="" |SRC="img|
|00000510| 31 30 2e 70 6e 67 22 0a | 20 41 4c 54 3d 22 5c 62 |10.png".| ALT="\b|
|00000520| 65 67 69 6e 7b 64 65 73 | 63 72 69 62 65 7d 0a 5c |egin{des|cribe}.\|
|00000530| 69 74 65 6d 5b 5c 76 65 | 72 62 5c 76 65 72 74 20 |item[\ve|rb\vert |
|00000540| 61 70 5c 76 65 72 74 3a | 5d 20 54 68 65 20 61 64 |ap\vert:|] The ad|
|00000550| 64 72 65 73 73 20 73 74 | 72 75 63 74 75 72 65 20 |dress st|ructure |
|00000560| 77 69 74 68 20 74 68 65 | 20 61 64 64 72 65 2e 2e |with the| addre..|
|00000570| 2e 0a 2e 2e 2e 65 6e 64 | 7b 64 69 73 70 6c 61 79 |.....end|{display|
|00000580| 6d 61 74 68 7d 54 68 69 | 73 20 69 73 20 75 73 75 |math}Thi|s is usu|
|00000590| 61 6c 6c 79 20 69 6e 70 | 75 74 20 66 72 6f 6d 20 |ally inp|ut from |
|000005a0| 74 68 65 20 63 68 61 6e | 6e 65 6c 20 73 74 72 75 |the chan|nel stru|
|000005b0| 63 74 75 72 65 2e 0a 5c | 65 6e 64 7b 64 65 73 63 |cture..\|end{desc|
|000005c0| 72 69 62 65 7d 22 3e 0a | 3c 42 52 3e 0a 0a 3c 50 |ribe}">.|<BR>..<P|
|000005d0| 3e 0a 54 68 69 73 20 72 | 6f 75 74 69 6e 65 20 72 |>.This r|outine r|
|000005e0| 65 74 75 72 6e 73 20 61 | 6e 20 3c 63 6f 64 65 3e |eturns a|n <code>|
|000005f0| 52 50 3c 2f 63 6f 64 65 | 3e 20 63 6f 64 65 20 77 |RP</code|> code w|
|00000600| 68 69 63 68 20 63 61 6e | 20 62 65 20 63 68 65 63 |hich can| be chec|
|00000610| 6b 65 64 20 77 69 74 68 | 0a 3c 63 6f 64 65 3e 72 |ked with|.<code>r|
|00000620| 70 5f 69 73 67 6f 6f 64 | 3c 2f 63 6f 64 65 3e 20 |p_isgood|</code> |
|00000630| 74 6f 20 73 65 65 20 69 | 66 20 74 68 65 20 61 64 |to see i|f the ad|
|00000640| 64 72 65 73 73 20 77 61 | 73 20 70 61 72 73 65 64 |dress wa|s parsed|
|00000650| 2e 20 49 66 20 69 74 20 | 66 61 69 6c 73 2c 20 61 |. If it |fails, a|
|00000660| 0a 73 75 69 74 61 62 6c | 65 20 65 72 72 6f 72 20 |.suitabl|e error |
|00000670| 77 69 6c 6c 20 62 65 20 | 77 72 69 74 74 65 6e 20 |will be |written |
|00000680| 69 6e 20 74 68 65 20 3c | 63 6f 64 65 3e 52 50 5f |in the <|code>RP_|
|00000690| 42 75 66 3c 2f 63 6f 64 | 65 3e 20 73 74 72 75 63 |Buf</cod|e> struc|
|000006a0| 74 75 72 65 2e 0a 0a 3c | 50 3e 0a 57 68 65 6e 20 |ture...<|P>.When |
|000006b0| 64 65 6c 69 76 65 72 69 | 6e 67 20 74 6f 20 6c 6f |deliveri|ng to lo|
|000006c0| 63 61 6c 20 61 64 64 72 | 65 73 73 65 73 20 69 74 |cal addr|esses it|
|000006d0| 20 69 73 20 6f 66 74 65 | 6e 20 6e 65 63 65 73 73 | is ofte|n necess|
|000006e0| 61 72 79 20 74 6f 20 72 | 65 64 75 63 65 20 61 0a |ary to r|educe a.|
|000006f0| 67 6c 6f 62 61 6c 20 61 | 64 64 72 65 73 73 20 64 |global a|ddress d|
|00000700| 6f 77 6e 20 74 6f 20 61 | 20 75 73 65 72 20 6f 66 |own to a| user of|
|00000710| 20 74 68 65 20 73 79 73 | 74 65 6d 2e 20 54 68 65 | the sys|tem. The|
|00000720| 20 72 6f 75 74 69 6e 65 | 0a 3c 63 6f 64 65 3e 61 | routine|.<code>a|
|00000730| 64 5f 67 65 74 6c 6f 63 | 61 6c 3c 2f 63 6f 64 65 |d_getloc|al</code|
|00000740| 3e 20 63 61 6e 20 62 65 | 20 6f 66 20 75 73 65 20 |> can be| of use |
|00000750| 68 65 72 65 2e 20 54 68 | 69 73 20 72 6f 75 74 69 |here. Th|is routi|
|00000760| 6e 65 20 74 61 6b 65 73 | 20 61 6e 20 61 64 64 72 |ne takes| an addr|
|00000770| 65 73 73 0a 61 6e 64 20 | 72 65 74 75 72 6e 73 20 |ess.and |returns |
|00000780| 6a 75 73 74 20 74 68 65 | 20 6c 6f 63 61 6c 20 70 |just the| local p|
|00000790| 61 72 74 20 6f 66 20 69 | 74 20 69 66 20 61 6e 79 |art of i|t if any|
|000007a0| 2c 20 65 6c 73 65 20 3c | 63 6f 64 65 3e 4e 55 4c |, else <|code>NUL|
|000007b0| 4c 43 50 3c 2f 63 6f 64 | 65 3e 2e 20 49 74 0a 69 |LCP</cod|e>. It.i|
|000007c0| 73 20 63 61 6c 6c 65 64 | 20 61 73 20 66 6f 6c 6c |s called| as foll|
|000007d0| 6f 77 73 3a 0a 0a 3c 50 | 3e 0a 3c 42 4c 4f 43 4b |ows:..<P|>.<BLOCK|
|000007e0| 51 55 4f 54 45 3e 0a 3c | 41 20 49 44 3d 22 32 31 |QUOTE>.<|A ID="21|
|000007f0| 38 22 3e 3c 2f 41 3e 3c | 2f 42 4c 4f 43 4b 51 55 |8"></A><|/BLOCKQU|
|00000800| 4f 54 45 3e 3c 50 52 45 | 3e 0a 63 68 61 72 20 2a |OTE><PRE|>.char *|
|00000810| 61 64 5f 67 65 74 6c 6f | 63 61 6c 20 28 61 64 64 |ad_getlo|cal (add|
|00000820| 72 2c 20 74 79 70 65 2c | 20 72 65 73 70 29 0a 63 |r, type,| resp).c|
|00000830| 68 61 72 20 2a 61 64 64 | 72 3b 0a 69 6e 74 20 74 |har *add|r;.int t|
|00000840| 79 70 65 3b 0a 69 6e 74 | 20 72 65 73 70 3b 0a 3c |ype;.int| resp;.<|
|00000850| 2f 50 52 45 3e 0a 0a 3c | 50 3e 0a 54 68 65 20 61 |/PRE>..<|P>.The a|
|00000860| 72 67 75 6d 65 6e 74 73 | 20 61 72 65 3a 0a 3c 42 |rguments| are:.<B|
|00000870| 52 3e 0a 3c 49 4d 47 0a | 20 20 53 54 59 4c 45 3d |R>.<IMG.|  STYLE=|
|00000880| 22 22 20 53 52 43 3d 22 | 69 6d 67 31 31 2e 70 6e |"" SRC="|img11.pn|
|00000890| 67 22 0a 20 41 4c 54 3d | 22 5c 62 65 67 69 6e 7b |g". ALT=|"\begin{|
|000008a0| 64 65 73 63 72 69 62 65 | 7d 0a 5c 69 74 65 6d 5b |describe|}.\item[|
|000008b0| 5c 76 65 72 62 5c 76 65 | 72 74 20 61 64 64 72 5c |\verb\ve|rt addr\|
|000008c0| 76 65 72 74 3a 5d 20 41 | 20 73 74 72 69 6e 67 2d |vert:] A| string-|
|000008d0| 65 6e 63 6f 64 65 64 20 | 66 6f 72 6d 20 6f 66 20 |encoded |form of |
|000008e0| 74 68 65 20 61 64 64 72 | 65 2e 2e 2e 0a 2e 2e 2e |the addr|e.......|
|000008f0| 6e 74 2c 20 74 68 69 73 | 20 76 61 6c 75 65 20 73 |nt, this| value s|
|00000900| 68 6f 75 6c 64 0a 62 65 | 20 5c 76 65 72 62 5c 76 |hould.be| \verb\v|
|00000910| 65 72 74 20 31 5c 76 65 | 72 74 2c 20 65 6c 73 65 |ert 1\ve|rt, else|
|00000920| 20 5c 76 65 72 62 5c 76 | 65 72 74 5c 76 65 72 74 | \verb\v|ert\vert|
|00000930| 2e 0a 5c 65 6e 64 7b 64 | 65 73 63 72 69 62 65 7d |..\end{d|escribe}|
|00000940| 22 3e 0a 3c 42 52 3e 0a | 0a 3c 50 3e 0a 0a 3c 48 |">.<BR>.|.<P>..<H|
|00000950| 52 3e 0a 0a 3c 2f 42 4f | 44 59 3e 0a 3c 2f 48 54 |R>..</BO|DY>.</HT|
|00000960| 4d 4c 3e 0a             |                         |ML>.    |        |
+--------+-------------------------+-------------------------+--------+--------+